CONTENTS
NETMANAGE

Internet Solutions Pack Developer's Guide

The following Help Topics are available:

Getting Started

About Internet Slotions Pack

ActiveX Control Groups

ActiveX Control Architecture

Summary of ActiveX Controls

Installation Requirements

Supported Environments

For Help on Help, Press F1.


NetManage Info
NetManage

NetManage develops, markets and supports an integrated set of TCP/IP inter-networking applications and development tools for Microsoft Windows.  NetManage software facilitates communication, productivity and the administration of personal computers across dissimilar networking environments.  The Company's award-winning product families include Chameleon and ECCO.

The company is located at 10725 De Anza Blvd. Cupertino, CA  95014, U.S.A.

Phone: 408-973-7171 Fax: 408-973-8272.

International phone: +972-4-8550234 Fax +972-4-8550122


Getting Started

This help file is an introduction to NetManage's Internet Solutions Pack. It includes an introduction to ActiveXControls, requirements for installing your software, and a number of technical tips for programmers.


About the Internet Solutions Pack

NetManage's Internet Solutions Pack is a set of eight components and mechanisms based on ActiveX (formerly OLE Custom Control) technology that makes programming for the Internet easy and powerful at the same time.

All users can use ActiveX Controls to enhance their applications with Internet features and make them Internet-enabled.  Controls can also be used by an expert programmer to develop complete applications for the Internet and to use all features of Internet protocols.

The Internet Solutions Pack can be used to build applications such as customer support systems, sales management, human resources, and other information sharing applications.  It lets corporate developers build customized business solutions for use within their corporate internal network to run on top of Windows NT and Windows '95.


OLE Control Groups
ActiveX Control Groups

Controls shipped in this release consist of the following groups:

Basic Winsock Controls

Protocol Client Controls

Infrastructure Controls and COM objects.

WEB Controls


Basic WinSock Controls

TCP/UDP support


Protocol Client Controls

These controls provide support for miscellaneous Internet protocols at the client side, such as POP3 and NNTP.


Web Controls

These control provide support for the World Wide Web.


Infrastructure Controls and COM Objects

Components used to support all the other Controls, the sharing of data, document streaming using DocStream objects, and  MIME header parsing used in many Internet protocols.


Summary of OLE Controls
Summary of ActiveX Controls

Control Category	Description
Basic WinSock Controls	TCP/UDP Control
Protocol Client Controls	FTP, NNTP, HTTP, POP3, SMTP
WEB Controls	HTML
Infrastructure Controls	DocStream


OLE Control Architecture
ActiveX Control Architecture

ActiveX architecture is based on:

DocStreams

Properties, Methods, and Events


DocStreams

Internet Solutions Pack is designed as a family of controls with a few common interfaces that allow you to develop applications quickly. Famliarizing yourself with these common interfaces can save you time later.

DocInput and DocOutput Objects

An innovative feature of Internet Solutions Pack is the DocInput object and the DocOutput object.  These objects, accessible from all controls except the WinSock controls, have properties and methods that allow you to stream data from one control to another.  For example, using the DocOutput object, you can automatically stream data from a HTTP server to an FTP control when you wish to archive the data on an FTP server.

icError Object and Collection

Another common object is the icError object and icErrors collection.  The icError object stores error messages that originate from a network server.  As errors may be numerous, the icError object can be stored in a collection for later retrieval.

DocHeader Object and Collection

Some protocols, such as the MIME and the SMTP, require you to create a collection of document headers. For example, when sending a mail message, you will see these headers:

From: Jonne@Maui.com
To: TomS@Haleakala.com
Subject: Run to the Sun
Message-Id: 9601138242.AA824256464@mail.Maui.com

Each line in the above example would be contained in a single DocHeader object, and all four lines would be part of a DocHeaders collection.


Properties, Methods, and Events

All controls are based on clearly defined interfaces consisting of properties, methods, and events.  Properties indicate specific attributes such as color, remote host and port number.  They are set in a properties form before running each control.

Methods perform an action on the object, such as connect or authenticate, and events are notifications generated after a particular action has been performed.  For example, each control has a StateChanged event to notify you of the current state or that a state has changed. A common scenario when working with ActiveX controls is to set properties, run methods and request an event as follows:

Action	Example
Set Properties	Myclient.RemoteHost = "mail" Myclient.UserName = "josmith"
Method	Connect Authenticate
Event	ProcessData


Installation Requirements

This section lists the hardware and software requirements for installing the Internet Solutions Pack.  For detailed installation instructions refer to the Installation card provided in the Software Developer's package.

Before you proceed, make sure you have the following:

•	A CD labeled Internet Solutions Pack -NetManage Enhanced Windows TCP/IP

•	Internet Solutions Pack Developer's Guide

•	Windows NT or Windows '95 installed

•	IBM PC, XT, AT, 386/486 Based, PS/2 or compatible.

You do not need any additional tools to run the samples provided in executable form (.exe files).


Supported Environments

The Internet Solutions Pack has been tested with the following development and run-time environments, running on both Windows 95 and Windows NT 3.51.  It is compatible with any other environments that support ActiveX Control components.


ActiveX

ActiveX is a trademark of Microsoft Corporation.